Skip to content

Conversation

@kyeoungwoon
Copy link
Member

@kyeoungwoon kyeoungwoon commented Jan 6, 2026

✅ 체크리스트

  • merge 타겟 브랜치 잘 설정되었는지 확인하기 (fe/dev, be/dev)

🔥 연관 이슈

해결되는 Issue의 경우 closes나 resolves 키워드를 사용해주세요.

🚀 작업 내용

  1. WootecoStyle을 .editorconfig로 변경해서 작성하였습니다.
  2. PR 및 Issue 템플릿을 소폭 수정하였습니다.
  3. 해당 커밋에서 날라가버린 asciidocs 관련 설정을 복구하였습니다.

💬 리뷰 중점사항

코드 중에서 특별히 고려하였거나 토론하고 싶은 부분이 있다면 명시해주세요.

📃 관련 문서

Team Document Hub나 Wiki에 작성한 문서가 있다면 링크를 첨부해주세요.

Summary by CodeRabbit

  • 신기능

    • Spring REST Docs와 Asciidoctor 통합으로 API 문서 자동 생성 및 빌드 시 문서가 앱에 포함됩니다.
  • Chores

    • 다수 언어·파일형식을 아우르는 일관된 코드 포맷팅 규칙을 추가했습니다.
    • GitHub 이슈 템플릿(작업/문서/기타)과 풀 리퀘스트 템플릿을 추가·개선하여 제출 가이드가 강화되었습니다.
    • 일부 템플릿의 형식·개행 문제를 수정했습니다.

✏️ Tip: You can customize this high-level summary in your review settings.

Copilot AI review requested due to automatic review settings January 6, 2026 07:27
@coderabbitai
Copy link

coderabbitai bot commented Jan 6, 2026

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

프로젝트에 광범위한 .editorconfig 구성 추가, GitHub 이슈/PR 템플릿 3건 추가·수정, 그리고 Gradle에 Asciidoctor 기반 Spring REST Docs 연동(테스트 → 스니펫 생성 → Asciidoctor → bootJar 포함) 빌드 태스크를 추가했습니다.

Changes

코호트 / 파일(s) 변경 요약
편집기 구성
​.editorconfig
다중 언어(CSS, Dart, Java, Less, Proto, Sass/SCSS, Vue, TS, Bash, CJS/JS, JSON, HTML, HTTP, JSP, Kotlin, MD, Properties, Qute, TOML, YAML 등)에 대한 글로벌 및 언어별 포맷 규칙 대규모 추가(인코딩, EOL, indent, max_line_length, 따옴표/공백/정렬/래핑 규칙 등).
GitHub 템플릿
​.github/ISSUE_TEMPLATE/chore.md, ​.github/ISSUE_TEMPLATE/docs-creation.md, ​.github/pull_request_template.md
Chore/Docs 이슈 템플릿 신규 추가 및 PR 템플릿 수정(머지 대상 브랜치 명시 업데이트, PR 제목 규칙 확인 항목 추가, 작업 내용 작성 가이드 보강, 일부 공백/파일 종료 개행 정리).
빌드 설정 / 문서 생성
build.gradle.kts
Asciidoctor 플러그인(id("org.asciidoctor.jvm.convert") version "4.0.5") 추가, asciidoctorExt 구성 및 Spring REST Docs 의존성 추가, snippetsDir 선언, tasks.testtasks.asciidoctortasks.bootJar 의존성 연결 및 bootJarasciidoctor 출력물을 static/docs로 포함하도록 설정.

Sequence Diagram(s)

sequenceDiagram
    autonumber
    participant Test as Task:test
    participant Snippets as build/generated-snippets
    participant Asciidoctor as Task:asciidoctor
    participant BootJar as Task:bootJar
    Note over Test,Snippets: 테스트 실행 → REST Docs 스니펫 생성
    Test->>Snippets: outputs.dir(snippetsDir)
    Test-->>Asciidoctor: 테스트 완료 (asciidoctor dependsOn test)
    Asciidoctor->>Snippets: inputs.dir(snippetsDir)
    Asciidoctor->>Asciidoctor: .adoc → HTML/docs 변환
    Asciidoctor-->>BootJar: 변환 완료 (bootJar dependsOn asciidoctor)
    BootJar->>Asciidoctor: from(asciidoctor.outputDir) 복사하여 포함
    Note over BootJar: 최종 JAR에 static/docs 포함
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Poem

🐰 줄 맞춘 숲에 규칙을 심었네,
탭과 줄바꿈 춤추는 밤,
템플릿은 메모를 속삭이고,
테스트가 남긴 조각들 모아,
토끼는 문서 빛에 깡충 깡충 ✨

Pre-merge checks and finishing touches

✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed PR 제목이 변경 사항의 주요 내용(.editorconfig 생성, PR/Issue 템플릿 수정, gradle 설정 복구)을 명확하게 설명하고 있습니다.
Description check ✅ Passed PR 설명이 템플릿의 필수 섹션(체크리스트, 연관 이슈, 작업 내용)을 포함하고 있으며, 각 작업 항목이 구체적으로 기술되어 있습니다.
Linked Issues check ✅ Passed 모든 변경사항이 연관 이슈의 요구사항을 충족합니다: #30 .editorconfig 추가, #27 Issue/PR 템플릿 수정, #33 gradle 설정 복구.
Out of Scope Changes check ✅ Passed 모든 변경사항이 연관 이슈 #30, #27, #33의 범위 내에 있으며, 범위 외 변경사항은 없습니다.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 29bc76f and 64681f5.

📒 Files selected for processing (2)
  • .github/ISSUE_TEMPLATE/docs-creation.md
  • .github/ISSUE_TEMPLATE/feature-template.md

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Fix all issues with AI Agents
In @.editorconfig:
- Line 6: The .editorconfig currently sets insert_final_newline = false which
causes POSIX non-compliance and tool conflicts; change the setting to
insert_final_newline = true in the .editorconfig file so files end with a
newline; update the single entry for insert_final_newline (search for the key
name "insert_final_newline") and commit the change so Git diffs, Prettier/ESLint
and build tools stop reporting missing end-of-file newlines.
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 77f3310 and 8527b1d.

📒 Files selected for processing (1)
  • .editorconfig
🔇 Additional comments (2)
.editorconfig (2)

14-14: ij_visual_guides 빈 값 의도 확인 필요

현재 ij_visual_guides = 설정이 값 없이 비어있습니다. 이것이 의도적으로 모든 시각 가이드를 비활성화하려는 것인지, 아니면 완성되지 않은 설정인지 확인이 필요합니다.

명시적으로 가이드를 비활성화하려면 현재 형태가 맞지만, 특정 컬럼에 가이드를 표시하려면 (예: 120,80) 값을 추가해야 합니다.


1-1250: WootecoStyle 표준 준수 확인 필요

파일 전체가 WootecoStyle 가이드라인을 따르고 있는지 검증이 필요합니다. 특히 다음 항목들에 대한 확인을 권장합니다:

  1. 들여쓰기 표준: 전역 설정은 4칸이지만, CSS/JSON/YAML 등 많은 파일 타입에서 2칸으로 오버라이드됨 - WootecoStyle에서 의도한 설정인지 확인
  2. Java 포매팅: 광범위한 Java 설정(wildcard import 금지 등)이 팀의 Java 코딩 가이드와 일치하는지 확인
  3. TypeScript/JavaScript: 엄격한 포매팅 규칙(예: imports_wrap = on_every_item)이 프로젝트 요구사항과 일치하는지 확인

WootecoStyle 공식 문서나 팀 가이드와의 대조를 통해 모든 설정이 의도된 표준과 정렬되어 있는지 재확인하시기 바랍니다.

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

이 PR은 WootecoStyle 기반의 .editorconfig 파일을 프로젝트에 추가합니다. 1,254줄에 달하는 포괄적인 코드 스타일 설정이 포함되어 있으며, Java, TypeScript, JavaScript, Kotlin, Groovy 등 다양한 언어에 대한 포매팅 규칙을 정의합니다.

주요 변경사항:

  • WootecoStyle을 따르는 .editorconfig 파일 추가
  • Java 코드 스타일: 4칸 들여쓰기, end_of_line 중괄호 스타일, 999개 클래스까지 개별 import 사용
  • 프론트엔드 언어들(TypeScript, JavaScript 등)은 2칸 들여쓰기 적용

참고: PR 제목에 "PR/Issue 템플릿 수정"이 언급되어 있으나, 실제 변경사항에는 템플릿 파일이 포함되지 않았습니다.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In @build.gradle.kts:
- Around line 138-148: The Asciidoctor task (tasks.asciidoctor) is missing an
attributes entry to expose the snippets directory to .adoc files; update the
tasks.asciidoctor configuration to add an attributes mapping that sets the
"snippets" attribute to the existing snippetsDir variable so Asciidoctor can
resolve {snippets} includes (e.g., configure attributes to point "snippets" ->
snippetsDir).
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 8527b1d and 9cc5082.

📒 Files selected for processing (4)
  • .github/ISSUE_TEMPLATE/chore.md
  • .github/ISSUE_TEMPLATE/docs-creation.md
  • .github/pull_request_template.md
  • build.gradle.kts
🔇 Additional comments (9)
.github/ISSUE_TEMPLATE/chore.md (1)

5-5: 라벨 정의의 일관성 검증 필요

Chore 템플릿의 라벨 정의가 다른 이슈 템플릿(예: docs-creation.md의 ':memo: Docs')과 불일치합니다. D-3 라벨의 의도(우선순위, 기한, 또는 초기 설정값)를 명확히 하고, 기존 Bug/Feature 등 다른 이슈 템플릿과의 라벨 정의 일관성을 검증해주시기 바랍니다.

.github/ISSUE_TEMPLATE/docs-creation.md (1)

9-18: 명확한 지침과 좋은 구조

Docs 이슈 템플릿은 명확한 두 섹션(문서화 대상 + 작업 내용)과 실질적인 예시를 제공하여 기여자가 이해하기 쉽습니다. 라벨 정의도 간결하고 일관성 있게 구성되었습니다.

.github/pull_request_template.md (2)

3-4: PR 템플릿 개선 - 명확한 지침 추가

병합 대상 브랜치 명시(prod: main, dev: develop)와 PR 제목 컨벤션 체크리스트 추가는 기여자의 실수를 줄이고 일관성을 높이는 좋은 개선입니다.


14-15: 작업 내용 섹션의 지침 개선

구체적 작성 요청과 외부 문서 링크 가이드를 추가하여 기여자가 더 명확한 정보를 PR에 포함하도록 유도하는 점이 좋습니다.

build.gradle.kts (5)

23-23: LGTM!

Spring REST Docs를 위한 커스텀 configuration 생성이 올바르게 구성되었습니다.


121-124: LGTM!

Spring REST Docs 의존성이 올바르게 추가되었습니다. 버전은 Spring Boot BOM에서 관리되므로 명시하지 않은 것이 적절합니다.


131-136: LGTM!

테스트 실행 시 REST Docs 스니펫이 생성될 디렉토리가 올바르게 구성되었습니다.


150-155: LGTM!

생성된 API 문서가 bootJar에 올바르게 포함되도록 구성되었습니다. 문서는 애플리케이션 실행 시 /docs/ 경로에서 제공됩니다.


5-5: 플러그인 버전 확인 완료 - 추가 조치 불필요

Asciidoctor 플러그인 버전 4.0.5는 현재 최신 안정 버전(2025년 8월 25일 릴리스)이며 Spring Boot 3.5.9 및 Java 21 환경과 완전히 호환됩니다. 빌드 설정이 올바르게 구성되어 있으므로 버전 업그레이드나 구성 변경이 필요하지 않습니다.

Copilot AI review requested due to automatic review settings January 7, 2026 01:00
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In @.editorconfig:
- Around line 483-659: 에디터설정에서 TypeScript와 JavaScript 블록에 동일한 규칙이 중복 정의되어 있어
유지보수가 어렵습니다; ij_typescript_* 및 대응하는 ij_javascript_* 키들(예:
ij_typescript_blank_lines_around_class, ij_javascript_blank_lines_around_class
등)을 찾아 공통 규칙을 하나의 명시된 섹션으로 통합하거나(가능한 범위 내에서) 공통 규칙 목록 문서화 및 변경 체크리스트를 추가하도록
수정하세요; 구체적으로는 중복된 속성들을 한 곳에 모아 주석으로 “공통 규칙”을 만들거나 변경 가이드를 추가하고, 각 블록에는 오직 언어 특화된
차이만 남기며 자동화 검증 스크립트(또는 체크리스트) 추가를 제안하도록 주석 및 문서에 명시하세요.
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 9cc5082 and 78e8747.

📒 Files selected for processing (1)
  • .editorconfig
🔇 Additional comments (1)
.editorconfig (1)

1-16: 글로벌 설정이 적절하게 구성되었습니다.

POSIX 표준 준수 및 프로젝트 전반의 포매팅 기본값이 잘 설정되었습니다. 특히 Line 6의 insert_final_newline = true는 이전 CodeRabbit 권고사항이 반영된 것으로, Git 호환성과 빌드 도구 경고 문제를 해결합니다.

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 4 out of 5 changed files in this pull request and generated no new comments.

@kyeoungwoon kyeoungwoon changed the title [Feat] WootecoStyle 기반 .editorconfig 생성 및 PR/Issue 템플릿 수정 [Feat] .editorconfig 생성 및 PR/Issue 템플릿 수정, 테스트 관련 gradle 설정 복구 Jan 7, 2026
Copilot AI review requested due to automatic review settings January 7, 2026 02:44
@kyeoungwoon kyeoungwoon merged commit b2be09b into develop Jan 7, 2026
2 of 3 checks passed
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 5 out of 6 changed files in this pull request and generated no new comments.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants